一、下载与库配置
此章节主要为 XAPP SDK 的下载相关说明及库使用时的配置信息说明。
1、下载
请从资源下载处下载 XAPP SDK 库文件
注意：请确保下载的压缩包解压后包括了以下的文件
- xlink_sdk.jar
- xlink_common.jar
- xlink_task_lib.jar
- xlink_wrapper.jar
- xlink_restful.jar
- expiringmap-0.5.7.jar
2、XAPP SDK 导入指引
- 删除原来项目中引入libs文件夹下的所有前缀为 xlink_ 的jar(如果有引用旧文件)
- 将刚下载的 XAPP SDK 压缩包解压缩，将得到的所有 jar 文件夹导入到你的项目中
注意：请务必删除掉所有旧文件再导入，详细原因说明请查看版本升级
下面是关于 jar 的简单说明：
| jar 包 | 说明 |
|---|---|
| xlink_sdk xlink_common xlink_task_lib | XAPP SDK 的核心功能实现 |
| xlink_restful | XAPP SDK 所有相关的REST API实现,也包括了后台所有主要的API实现 推荐调用后台API时使用此JAR包 |
| xlink_wrapper | XAPP SDK依赖于Android环境的中间件,也是 XAPP SDK 默认的初始化入口及一些默认实现类 |
| expiringmap-0.5.7 | 第三方依赖库 |
3、库配置
XAPP SDK 引用库导入后，需要使用 gradle 进行一些配置工作，同时 mainfest 文件也需要进行一些权限配置。
注意：
1.旧版本的库配置与新版本有一些差异，如果从旧版本升级到新版本请参考版本升级-v5版本升级到v6.0.6.9版本
2.不同版本配置时有任何疑问请查看对应版本的版本升级
3.1、gradle 配置
XAPP SDK 中对一些第三方库有依赖关系，包括处理http请求的网络请求等，请根据确保添加以下依赖（依赖库版本可根据实际情况进行更新）
compile fileTree(include: ['*.jar'], dir: 'libs')
//网络请求库
compile 'com.squareup.retrofit2:retrofit:2.3.0'
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
compile 'com.squareup.retrofit2:converter-scalars:2.3.0'
compile 'com.squareup.okhttp3:logging-interceptor:3.8.1'3.2、manifest 权限与配置
mainifest文件的配置权限
<!--存储权限为日志文件需要,如果不需要提供日志的文件存储功能,也可以不提供此权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--wIFI权限用于本地及云端状态切换及网络状态的检测需要-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<!--网络权限用于云端连接的需要-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>二、更新说明
| 日期 | 说明 |
|---|---|
| 2018.09.04 | 修正文档说明错误 |
